~4Dgifts/toolbox/src/swtools/listSymbols README
The "syms" script in this directory was created for listing exported
functions in libraries (useful for checking spelling, searching for
a function, etc), and as "undef" to ensure all unresolved symbols are
accounted for. You may find it useful too, or maybe not.
examples:
which X11 dso contains "XOpenDisplay"?
% syms /usr/lib/libX*.so | grep XOpenDisplay
/usr/lib/libX11.so: XOpenDisplay
what functions does this plug-in expect to find elsewhere?
% undef 3D_Noise
3D_Noise: XFlush
3D_Noise: XKeysymToKeycode
3D_Noise: XQueryKeymap
[ long list abbreviated ]
What are the local (static) functions in the plug-in?
% syms -t 3D_Noise
3D_Noise: Random
3D_Noise: about_callback
usage: syms [-NTtDdBbAaUGgSsRrCEVIbXPFo] file1 file2 ...
All sections listed in nm(1) are supported:
NM(1) Silicon Graphics NM(1)
NAME
nm - name list dump of MIPS object files
SYNOPSIS
nm [ -abdefghnopruvxABTV ] [ files ]
DESCRIPTION
The nm command prints formatted listings of the symbol and external
sections of the symbol tables for each file specified. A file can be an
object or an archive. If you do not specify a file, nm assumes a.out.
The nm command supports the options listed below. NOTE: The meaning of
-n and -o depends on whether -A or -B is in effect when -n or -o is seen
(the meaning depends on the relative ordering of the options). Examples:
nm -Bo a.out
nm -oB a.out
In the first example o is given the -B meaning, while in the second, it
is given the -A meaning.
-A Use AT&T System V format output. This is the default.
-B Use Berkeley (4.3BSD) format output.
-a Print debugging information. When used with -B, nm uses -A
format output but with -B default ordering and value field radix.
-b Print the value field in octal.
-d Print the value field in decimal. This is the default value
field radix for -A.
-e Print externals and statics only.
-f Produce full output. nm still accepts this old option, but
ignores it.
-g When used with -B print only globally-visible names. When used
with -A this has no effect.
-h Do not print headers.
-n When used alone or with -A, sort external symbols by name. This
is the default sort order for -B.
When used with -B, sort all symbols by value.
-o When used alone or with -A, print the value field in octal.
Page 1 Release 5.2
NM(1) Silicon Graphics NM(1)
When used with -B, prepend the filename to each symbol. This is
useful for grepping through nm of libraries.
-p When used with -B, print symbols as they are found in the file.
This is the default ordering for -A.
-r Reverse the sense of a value or name sort.
-u Print only undefined symbols.
-v Sort external symbols by value.
-x Print value field in hexadecimal. This is the default value
field radix for -B.
-T Truncate long names, inserting a `*' as the last printed
character.
-V Print version information on stderr.
The -A System V format (default) and the -B Berkeley format specified
with -a debugging output provide an expanded listing with these fields:
Name The symbol or external name.
Value The value field for the symbol or external, usually an
address or interesting debugging information.
Class The symbol type.
Type The symbol's language declaration. A "*" at the far right
of the type field means the symbol is a weak symbol.
Size For Common and Small common symbols the size in bytes of the
Common. For other symbols Size is blank since size
information is not in the object file.
Index The symbol's index field.
Section The symbol's storage class.
NOTE: Every effort was made to map the each field's functionality into
System V nomenclature.
The -B Berkeley format produces the address or value field followed by a
letter showing what section the symbol or external is in and the name of
the symbol or external. Followed, if the symbol is a weak symbol, by
(weak).
These section letters describe the information that nm generates:
Page 2 Release 5.2
NM(1) Silicon Graphics NM(1)
N Nil storage class, compiler internal usage.
T External text.
t Local text.
D External initialized data.
d Local initialized data.
B External zeroed data.
b Local zeroed data.
A External absolute.
a Local absolute.
U External undefined.
G External small initialized data.
g Local small initialized data.
S External small zeroed data.
s Local small zeroed data.
R External read only.
r Local read only.
C Common.
E Small common.
V External small undefined.
I Init section (normally shared library initialization code).
b Fortran based variable
X Exception data
P Procedure section (not a normal variable).
F Fini section.
o Non GP data item (item not put in a small data area even
though it may be small enough to fit).
Page 3 Release 5.2
NM(1) Silicon Graphics NM(1)
SEE ALSO
collide(1), stdump(1), odump(1), nlist(3x)
Page 4 Release 5.2
Documentation
OR, ...